home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
rbbs_pc
/
rbbsdocs.zip
/
RBBSDOCS.10
< prev
next >
Wrap
Text File
|
1990-11-05
|
99KB
|
1,798 lines
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-1
10. USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC
---------------------------------------------------
The CONFIG program creates and edits the RBBS?PC.DEF files. These files
contain configuration information for each node of RBBS-PC. CONFIG also
edits the "sub-board" configuration files. Lastly, CONFIG contains
functions for periodic maintenance, such as create and pack MESSAGE and
USER files, renumber messages, and modem firmware initialization.
A sample RBBS-PC.DEF file is supplied with RBBS-PC. New SysOps are urged
to use this sample, as it will avoid many of the "first-time" setup errors.
Once you are comfortable with your RBBS-PC, CONFIG will allow you to shape
your BBS as you desire.
CONFIG is divided into many screens. They are:
Screen Description
1 Global RBBS-PC Parameters (Part 1 of 3)
2 Global RBBS-PC Parameters (Part 2 of 3)
3 Global RBBS-PC Parameters (Part 3 of 3)
4 RBBS-PC System Files (part 1)
5 RBBS-PC System Files (part 2)
6 Parameters for RBBS-PC "doors"
7 Parameters for RBBS-PC Security (part 1)
8 Parameters for RBBS-PC Security (part 2)
9 Parameters for Multiple RBBS-PC's and "conferences"
10 RBBS-PC Utilities
11 Parameters for RBBS-PC's File Management System
12 RBBS-PC Communications Parameters (part 1)
13 RBBS-PC Communications Parameters (part 2)
14 RBBS-PC Net Mail
15 New users parameters
16 Use of the Library Sub-System
17 RBBS-PC Color parameters
18 Reserved for future use
You may scroll forward or backward through the screens by using the PgUp
and PgDn keys on the keyboard. Additionally, you may go directly to a
specific screen by pressing a function key (F1 through F10) or SHIFT and a
function key (shift/F1 through Shift F7) corresponding to the page to be
selected. To terminate CONFIG, press the "End" key on the keyboard.
CONFIG can be invoked with the command:
CONFIG <config file>
The <config file> is an optional name of the configuration file to be
created or edited. If no config file is specified, CONFIG will edit the
file RBBS-PC.DEF in the current subdirectory. Each CONFIG parameter, and
the default values are explained in the following sections.
10.1 Global RBBS-PC Parameters (Part 1 of 3)
--------------------------------------------
Parameters 1 and 2 TOM MACK
The RBBS-PC system operator's (SysOp) first and last name. Enter your
REAL name here (the name you wish your callers to know you by). NO
ONE may log in to your RBBS-PC using this name, NOT EVEN THE SYSOP!
This is a security feature of RBBS-PC. The SysOp logs on with a
"pseudonym" (see parameter 121).
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-2
Parameter 3 EXPERT
The mode (EXPERT of NOVICE) for the SysOp. This option is now
obsolete. The SysOp may use the RBBS-PC eXpert command.
Parameter 4 0800 to 2200
The SysOp's "office hours", or when a user can page the SysOp. If a
caller attempts to page you outside these hours, he will be told you
are not available, and RBBS-PC will suggest that he try a MSG or a
COMMENT. The times are set using a 24-hour military clock (i.e. 10:00
P.M. is 2200 hours). The SysOp can disable a caller's ability to page
him COMPLETELY by pressing the function key F4 while RBBS-PC is
running. F4 toggles the SysOp page status off and on.
Parameter 5 NO
Because the bell on an attached printer is often louder than the one
built into the PC, the SysOp can elect to have the printer's bell
used, rather than "beeping" the PC's speaker.
Parameter 6 YES
Should RBBS-PC automatically take itself off-line if a "disk full"
condition occurs. In some instances, such as having a small disk
volume for uploads, you may want your RBBS-PC system to remain online,
even though it is getting disk space full errors.
Parameter 7 OFF
The default setting for the "prompt bell". The prompt bell refers to
a preference some callers have of getting a short "beep" from the
system, whenever it pauses for input at a prompt. When this is on,
both the remote user and the local SysOp will hear the prompt bell
when input is required from the remote user, unless and until this
option is changed with the Toggle command on the Utility menu.
Parameter 8 72 MINUTES
The maximum amount of time (in minutes) each user is to be allowed on
the system per session (the "session" refers to any individual call to
the bulletin board). This is the default time limit, which only takes
effect if the PASSWRDS file does not override. See section 15.3).
Parameter 9 0 MINUTES
The default total amount of time (in minutes) a caller is allowed on
RBBS-PC per day. This is the default time limit, which only takes
effect if the PASSWRDS file does not override. See section 15.3).
Parameter 10 1
This allows a SysOp to "reward" users who upload files by adding time
to the users session when they upload. This number will be multiplied
by the time spent in upload, and credited to the user. Setting this
parameter to 1 will give back the user as much time as they spent
uploading, so their session time will look "frozen" during upload.
These time credits are normally removed at the end of a day, unless
the ratio you set is greater than 1. If so, CONFIG will ask if you
want to make the time credits "survive." If so, the extra time
granted the user will be available indefinitely, instead of only for
the current day.
Parameter 11 1
The number of months inactivity that must elapse before a user is
considered a candidate for deletion from the USERS file when the SysOp
"rebuilds" it.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-3
Parameter 12 RBBS-PC
Allows the SysOp to specify the name of the RBBS-PC that is to be
displayed when a user first connects with the system and prior to
completing the logon process.
Parameter 13-15 FG=7, BG=0, BORDER=0
Allow the SysOp to specify the colors desired for the console display.
Foreground, Background, and Border may be set. When specifying
colors, use the following:
0 = Black 4 = Red
1 = Blue 5 = Magenta
2 = Green 6 = Brown
3 = Cyan 7 = White
Add 8 to any number to set high intensity. Add 16 to turn blink on.
Parameter 16 NO
If the RBBS-PC computer can support ANSI, RBBS-PC will send ANSI
control sequences to display color and position the cursor. The local
display does NOT have to support ANSI in order for callers to receive
ANSI commands, although it does make the "snoop" function readable.
Parameter 17 123
The decimal value (0 to 255) of the character used to identify
"SmartText" codes. This should ALWAYS be set to 123. See section 7.9
for a detailed discussion of SmartText.
Parameter 18 AUTOPAGE.DEF
The file name that contains the information to control the "automatic"
RBBS-PC paging of the SysOp. See section 7.11 for a detailed
description of the AutoPage feature.
Parameter 19 OLD & NEW
The level of detail to use when notifying callers of electronic
message. This can be set to (A)ll (old and new mail notifications),
(N)ew mail only, or (S)kip (no notification). See section 18 to get a
better understanding of the full flexibility of mail waiting
notification that has been built into RBBS-PC.
10.2 Global RBBS-PC Parameters (Part 2 of 3)
--------------------------------------------
Parameter 21 YES
Instructs RBBS-PC to remind users not only of the messages that are
for them, but also messages that they have left. This is to encourage
users to delete their old mail and help to keep the MESSAGES file to a
minimum.
Parameter 22 NO
Instructs RBBS-PC to remind users, when they login, how many files
they have downloaded and uploaded.
Parameter 23 NO
Reminds users every time they log on of the preferences they have
selected for such things as file transfer protocol, graphics, nulls,
etc.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-4
Parameter 24 NO
Allows users to download files immediately upon logging on to RBBS-PC.
Parameter 24 is only meaningful if the RBBS-PC File Management System
(FMS) has been enabled via parameter 214. RBBS-PC will scan FMS for
the newest uploads. When a caller logs on, RBBS-PC will determine how
many files are new since the caller last logged on. If parameter 24
is YES, the caller is offered the chance to immediately review these
new files and download them, if the caller has sufficient security to
download. This happens before the bulletins or messages are reviewed.
RBBS-PC's that emphasize software exchange may want to enable this
option, others may not want to give the caller a chance to download
the new files until after bulletins and messages have been reviewed.
Parameter 25 23
Allows the SysOp to establish a default page length for users when
they log on. The valid range is 0 to 255. If set to 0, the user will
receive continuously scrolling output.
Parameter 26 19
The maximum number (from 1 to 99) of lines allowed in each message.
Parameter 27 YES
Allows the SysOp to make the system "welcome" file interruptible. The
default is that YES it is interruptible. However, if the SysOp feels
too many people are bypassing it and it contains essential
information, the SysOp can set this parameter to NO (i.e. the user can
not suspend or cancel the listing of this file at their terminal with
a CTRL-S or CTRL-K). If the welcome file has intricate graphics,
interrupting it may leave the caller's screen in an odd color.
Parameter 28 YES
Allows the SysOp to indicate if the system bulletins are optional for
users when they log on. If bulletins are optional, callers can elect
to automatically bypass old bulletins and be notified only when there
are new bulletins. RBBS-PC will check the file date of the bulletins
and inform the caller which are new, with the option to read all of
the new bulletins. If none are new when bulletins are optional, the
bulletins will be automatically bypassed. See section 7.13.
Parameter 29 IBM PC
Tells RBBS-PC how to handle non-standard systems. The Compaq/Plus
uses interrupt X'7F', which is also used by MultiLink. RBBS-PC may
incorrectly detect MultiLink on a Compaq/Plus or other system that
makes use of interrupt X'7F', unless you select computer type 1. The
IBM PCjr's non-standard comm port mapping can be overcome if you
select computer type 2. Type 0 (IBM) and 3 (other) are treated the
same.
Parameter 30 - 34 (see CONFIG for defaults)
The symbol used to activate each online command can be changed. This
allows you great flexibility in how RBBS-PC interprets commands. You
can substitute any keyboard character for each command. To disable a
command, enter a single space for the symbol. One reason to change
commands is for macros. If you want to write an RBBS-PC macro that
acts as a "front end" for the command, you should first change the
symbol of the command to an unused, "hidden" symbol. Next, create the
macro, naming it the same as the original key. In the macro, you can
activate the original function by using the new "hidden" symbol.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-5
Parameter 35 YES
Allows the section name to precede the command prompt. The section is
MAIN, FILE, LIBRARY, or UTIL, if this option is selected. Otherwise,
the prompt will begin with YOUR. Normally the section in the prompt
helps the caller remember where he is, but see section 7.5 for reasons
to suppress the section.
Parameter 36 YES
Suppresses the display of commands in the command prompt. By default,
RBBS-PC reminds the caller what commands are available by giving a
sorted list of the letters used for each command in the command
prompt. RBBS-PC shows only the commands available in the section that
the caller is in.
Parameter 37 NO
RBBS-PC will either restrict commands to those in the current section,
or will look in ALL sections for a valid command that matches the
caller's request. See section 7.4.
Parameter 38 YES
Instructs RBBS-PC to use machine language subroutines (rather than the
BASIC routines) for selected functions. RBBS-PC includes both BASIC
and machine language versions of several functions. The machine
language version is much faster, but may cause problems with some non-
standard systems. Normally, you should activate the machine language
version, but if you encounter erratic behavior, especially in locating
files on a machine that may not be 100% IBM compatible, try using the
BASIC subroutines.
Parameter 39 NO
Instructs RBBS-PC to use the BASIC language's PRINT statement to write
to the screen of the PC that RBBS-PC is being run on. This is
sometimes necessary in "hostile" environments (i.e. multitasking,
special screen drivers, etc.) where the use of RBBS-PC's default call
to the RBBS-PC screen driver ANSI is not viable.
Parameter 40 2
The maximum number of additional lines that a caller can use to
describe a file that was uploaded. It applies to both single FMS
directories and non-FMS directories. NOTE: This number counts the
EXTENDED description lines. RBBS-PC always allows a single-line
description.
10.3 Global RBBS-PC Parameters (Part 3 of 3)
--------------------------------------------
Parameter 41 (NAME)
Determines how callers are to be identified when they log in. By
default, RBBS-PC uses the NAME field in the USER file. You may
specify the starting offset of the field, and its size. WARNING:
misuse of this parameter could DESTROY your USER file!
Parameter 42 <none>
Allows an additional field to be used to distinguish callers with the
same ID (see section 8). Normally, this item is set to 0, which
instructs RBBS-PC to not allow callers with identical IDs.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-6
Parameter 43 1
The offset into the USER record to be used to identify a user for
PERSONAL downloads. By default, RBBS-PC uses position 1, which is the
start of the caller's name.
Parameter 44 31
The length of the field used to identify a user for PERSONAL
downloads. By default, RBBS-PC uses 31 (the maximum length of a
user's name). The entries in the personal download directory must
have exactly this many bytes at the end -- plus one (for the flag used
to indicate if the file has been download).
Parameter 45 FIRST name
The prompt that RBBS-PC should use when asking the caller for the
first ID field. When prompting for this input, RBBS-PC will prepend
"What is your" to the prompt.
Parameter 46 LAST name
The prompt that should be used for the second ID field.
Parameter 47 NO
Activates upload/download ratios. See section 15.3 for a discussion
of the flexibility of RBBS-PC ratios. NOTE: If you elect to enforce
ratios, fields in the USER record are used to store ratio information.
See Appendix A for details.
Parameter 48 NO
Activates automatic security level reduction via Subscription date.
See section 9 for a complete explanation of subscriptions.
Parameter 49 5
The security level to which callers will be set when their
subscription expires (see section 9).
Parameter 50 60
The number of days BEFORE a caller's subscription is to expire that
RBBS-PC will send warnings. The file RGXPIRE.HLP can be customized to
inform the caller that the subscription is about to expire, and what
to do.
Parameter 51 365
The default number of days in a subscription period. When a caller
logs in this many days after their subscription began, RBBS-PC will
notify them of the expiration, display the file RGXPIRD.HLP, and
reduce their security to the level specified in parameter 49.
Parameter 52 NO
Instructs RBBS-PC to turn off printer logging each time RBBS-PC
"recycles" at the end of a call. Since printer errors will often
"hang" a system (especially if no printer is present), this function
can avoid errors caused by the SysOp accidentally activating RBBS-PC's
printer log function. Of course, if you wish to use the printer
logging feature, you must set this parameter to NO.
Parameter 53 NO
Instructs RBBS-PC to play musical themes for auditory feedback on what
is happening on the BBS. This can be important for SysOps that are
sight impaired. These musical themes are "played" on the speaker of
the PC that is running RBBS-PC, but not transmitted to the caller.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-7
Song played Meaning to SysOp
---------------------------------------------------------
"Consider Yourself" User log-on
"Walk Right In" New User log-on
"Dragnet Theme" Security violation
"Goodbye, Charlie" User log-off
"Taps" Caller denied access
"Oom Pah Pah" User downloading file
"Thanks for the Memories" User uploading file
Parameter 54 128
The buffer size used internally by RBBS-PC when displaying text files
such as menus, directories of files, etc. The size can range from 32
to 4096 characters. The bigger the buffer, the fewer disk accesses
necessary to display the file and the faster the display will be. The
default of 128 is the minimum recommended. Increasing this to 512
will increase the speed of text displays. However in some
environments where it is important to respond quickly to XON/XOFF
control, this should be set to the minimum of 32.
Parameter 55 1024
Sets the size of RBBS-PC's internal "stack." The internal stack is
used by RBBS-PC to keep track of program flow. The recommended value
is 2048. If you must conserve RAM usage, this number can be
decreased, but program errors such as "Stack overflow" and "String
Space Corrupt" could result.
Parameter 56 is not implemented in RBBS-PC.
Parameter 57 CITY and STATE
Specifies the prompt RBBS-PC should use when requesting the caller's
city & state. If you would like to record information other than city
& state in this USER field (telephone number, for example), change
this prompt accordingly.
Parameter 58 NO
Specifies how directories are sorted when a caller requests a list of
ALL download directories. You can either specify no sort, or the
directories can be shown in the order they appear in the "directory of
directories."
Parameter 59 1024
Specifies the buffer sized used during INTERNAL protocol transfers.
This is the amount of data stored before it is written to disk on
upload, or the amount read from disk at a time on download. The range
is 128 to 8192 characters (1024 is recommended).
Parameter 60 <none>
Specifies that either a Computalker (B.G. MICRO, P.O. Box 280298,
Dallas, Texas 75228) or HEARSAY 1000 (HEARSAY Inc., 1825 74th Street,
Brooklyn, N.Y. 11204) speech board is being used. This is in support
of the sight impaired SysOps. These voice synthesizers can speak
status messages that are usually either written to the CALLER log or
printed to the printer. With this, a sight-impaired SysOp can hear
what the caller on the BBS is doing.
To support as many speech boards as possible in the future, RBBS-PC uses a
64 entry file (RBBSTALK.DEF) to contain SysOp-definable fields. The file
is accessed randomly with fixed-length 32 byte records. The last two bytes
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-8
must contain CR/LF leaving 30 bytes available for the text. The 64 records
are predefined and used by RBBS-PC as follows:
1 = LOGON USER MESSAGE
2 = MAIN MENU PROMPT
3 = FILES MENU PROMPT
4 = UTILITY MENU PROMPT
5 = DOOR MENU PROMPT
6 = LIBRARY MENU PROMPT
7 = LOGOFF MESSAGE
8 = DOWNLOAD PROMPT
9 = UPLOAD PROMPT
10 = TIME REMAINING PROMPT
11 = WELCOME BACK PROMPT
12 = CONFERENCE MENU PROMPT
13-64 available for future enhancements
SmartText IS supported in the RBBSTALK.DEF records.
The CompuTalker requires the use of COM2, so the modem used by RBBS-PC must
NOT be connected to COM2.
10.4 Parameters for RBBS-PC System Files (part 1)
-------------------------------------------------
Parameter 61 \BULLET
The path and name of the text file that describes the BULLETINS.
RBBS-PC uses the path of this file to find ALL bulletin files.
Parameter 62 6
Instructs RBBS-PC to use "numbered" bulletins, and tells RBBS-PC how
many numbered bulletins to look for (see section 7.13).
Parameter 63 BULLET
Specifies the PREFIX of the Bulletin files. Ex: If the prefix is "B",
and a user asks to see bulletin INFO, RBBS-PC will look for the file
"BINFO" in the same directory as the file specified in parameter 61.
Additionally, if the file "BINFO.MNU" is found, RBBS-PC will activate
the Sub-Menu feature (see section 7.7). If the user has specified
graphics or color display, the files, RBBS-PC will also search for the
files "BINFOG" and "BINFOC" (see section 6.3).
Parameter 64 (default drive)
Specifies the disk drive and path on which RBBS-PC will find on-line
"help" files.
Parameter 65 HELP0
Specifies the prefix for the last remaining "old-style" help files.
These files are supplied with RBBS-PC, and the prefix is "HELP."
There is no reason to change this parameter.
Parameter 66 HLP
Specifies the EXTENSION for the "new-style" help files. A full set of
online help is provided with RBBS-PC. There is no reason to change
this parameter, but if you do, all .HLP files must be renamed. Any
additional help files you wish to create should have this extension,
and be in the directory specified in parameter 64. If so, RBBS-PC
will treat your help files as if they were part of RBBS-PC, displaying
them to callers when they are requested.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-9
Parameter 67 UPCAT
The help file shown to callers when RBBS-PC asks them to categorize an
upload. With FMS directories (see section 12), a caller can specify
the category code for their upload. You need only specify the base
file name in this parameter. RBBS-PC will add the help file PATH (as
specified in parameter 64) and the EXTENSION (as specified in
parameter 66). This file should contain a description of each
category, so the uploade can properly categorize the upload.
Parameter 68 NEWUSER
The path and filename of the file new users see when they first log on
and before they "register" themselves in RBBS-PC's USERS file. A user
sees it once and only once during his first session.
Parameter 69 WELCOME
The path and filename of the file each user sees EVERY time AFTER they
log on.
Parameter 70 MENU1
The path and filename of the SysOp command menu, shown to callers in
NOVICE mode who have access to SysOp commands.
Parameter 71 MENU2
The path and filename of the MAIN section menu.
Parameter 72 MENU3
The path and filename of the FILE section menu.
Parameter 73 MENU4
The path and filename of the UTIL section menu.
Parameter 74 CONFENCE
The path and filename of the Conference description file. RBBS-PC
uses this file to when a caller asks for a list of your conferences,
and also uses the file to validate a JOIN command. In order for the
JOIN to work, the conference name (seven characters or less) must
appear IN CAPS, at the beginning of a line (preceding spaces are
allowed). The SysOp must already have pre-formatted the messages and
users files associated with the conferences (see section 17.3).
RBBS-PC will look for conference MESSAGE files in the path specified
in this parameter after searching where the main MESSAGE file is
located.
Parameter 75 MENUA
The path and filename containing the list of the questionnaires
callers can answer on-line (see section 19). Before RBBS-PC will
allow a caller to answer a questionnaire, it will look for the
questionnaire name specified (seven characters or less), IN CAPS, at
the beginning of a line in this file (preceding spaces are allowed).
Parameter 76 (default drive)
The drive and path where the questionnaire files are located.
Parameter 77 MAIN.PUI
The path and filename of the "Programmable User Interface" to be used.
See section 7.6 for a fuller description of RBBS-PC's PUI. CONFIG
will add the extension ".PUI" to this file. If this file is not
found, RBBS-PC uses the standard interface.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-10
Parameter 78 YES
Specifies whether RBBS-PC should insert page-breaks in menus.
Normally, you will want RBBS-PC to insert page-breaks when needed,
unless you have written "full-screen" menus which do ANSI cursor
positioning. In this case, the lines in the menu files may not
accurately reflect the lines used on the callers screen.
Parameter 79 (default drive)
The drive and path where RBBS-PC macros are stored.
Parameter 80 <none>
The extension for RBBS-PC macro files (usually .MCR). See section 7.8
for a full description of RBBS-PC's macro capabilities.
10.5 Parameters for RBBS-PC System Files (part 2)
-------------------------------------------------
Parameter 81 TRASHCAN
The path and filename of the "illegal name" file. This file is used
when a new user signs on. The new users first and last name are each
individually checked against the names in this file, as well as the
entire name.
The format of this file is as follows:
<name>,
An example of such a file would be:
BITE,
BYTE,
PAPA DOC,
DOCTOR,
DEATH,
GLADIATOR,
KILLER,
MAN,
THE
The comma is optional after each name. However, it does help in
delineating exactly what character strings are being searched for and
compared against (some text editors may add extraneous and non-visible
characters to a line). All names should be UPPER CASE! If the above file
existed, any new user who logged and used the following names would be
denied access:
Byte Killer
Kilo Man
Doctor Death
PC Doctor
Pappa Doctor
but "Hoppa Pappa" would be fine.
Parameter 82 <none>
The path and filename of the "required" questionnaire. RBBS-PC
records in the users record when the required questionnaire is
answered so that it will only ask each caller once. Both first-time
and old callers will be required to answer this questionnaire. When
you install a new required questionnaire, use CONFIG parameter 186 to
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-11
mark all user records so they will once again be required to answer
the questionnaire. NOTE: Parameter 82 allows you to specify a path.
RBBS-PC will not automatically look in the path specified in parameter
76.
Parameter 83 PRELOG
The path and filename displayed to callers as soon as carrier is
detected and BEFORE a user can log on. It is displayed immediately
after the name of the RBBS-PC is shown (see parameter 12). SysOps
should use this file to convey such information as whether real names
are required, 300 baud users will automatically be denied access, etc.
Parameter 84 RBBS-REG.DEF
The path and filename of the optional questionnaire RBBS-PC will
require new users to answer on their first call. See section 19 for
details on RBBS-PC questionnaires.
Parameter 85 EPILOG.DEF
The path and filename of the optional questionnaire RBBS-PC will ask
each caller when they log off each time from your RBBS-PC (see section
19).
Parameter 86 MESSAGES
The path and filename of the RBBS-PC message file. This file
contains all messages entered by callers, as well as configuration
data. If this file does not exist when you run CONFIG, CONFIG will
ask if it should create the file.
NOTE: Read section 18 if you want to include the main message file in the
scan for conference mail waiting.
Parameter 87 USERS
The path and filename of the RBBS-PC USER file. This file is where
RBBS-PC keeps track of the name and profile for each caller.
Parameter 88 COMMENTS
The path and filename where RBBS-PC will store comments that callers
leave to the SysOp. Even if comments are recorded as private messages
(see parameter 89), you should specify a COMMENTS file, since RBBS-PC
will place comments here if the MESSAGE file is full. RBBS-PC will
automatically create the COMMENTS file when needed.
Parameter 89 NO
allows SysOps to have comments recorded as private messages to them
in the main messages file providing there is any room. This allows
replies to comments to be done much more easily.
Parameter 90 CALLERS
The path and filename for RBBS-PC's CALLER log. RBBS-PC will create
this file, and log the date and time of each caller to the BBS.
Information such as uploads and downloads, security violations and
communications parameters are also logged. SysOp function 2 will
display this information.
Parameter 91 NO
Specifies that RBBS-PC should log the following additional information
in the callers log:
1) Connect not completed 9) Left comment at time
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-12
2) Sleep disconnect 10) Logged off at time
3) Caller changed name/address 11) Carrier dropped at time
4) Newuser 12) Message # xxxx left at
5) Bulletin x read 13) Read Messages ...
6) SysOp initiated Chat 14) Answered questionnaire xxx
7) Entered Conference/Sub-board x 15) Killed msg # xxxx
8) Time limit exceeded
NOTE: Each CALLER log entry uses 66 bytes of disk storage. Using parameter
91 can provide useful information, but you should monitor the size of your
CALLER log so it does not consume your entire disk!
Parameter 92 has not been implemented in RBBS-PC.
Parameter 93 CONFMAIL.DEF
The path and filename for the conference mail-scan file. This file
tells RBBS-PC which conferences should be checked when a caller wants
to scan for new mail. The format of this file and the flexibility it
affords the RBBS-PC SysOp is described more fully in section 18.
Parameter 94 30
The maximum number of "working variables" that RBBS-PC allocates for
questionnaires and macros. A "working variable" is simply a place in
which RBBS-PC can store a response or a set of characters. These
"working variables" can then be used to create parameters that can be
passed to "DOOR"s (see section 14.3) or written out to data bases (see
section 7.8.4).
10.6 Parameters for RBBS-PC "Doors"
-----------------------------------
Parameter 101 NO
Activates the DOOR function. See section 14 for a complete
description of the RBBS-PC door subsystem.
Parameter 102 MENU5
The path and filename of the DOOR menu, which RBBS-PC will show to the
caller when a list of doors is requested. Before RBBS-PC will allow a
caller to open a door, it will look for the door name specified (seven
characters or less), IN CAPS, at the beginning of a line in this file
(preceding spaces are allowed).
Parameter 103 RCTTY.BAT
The path and filename of the .BAT file RBBS-PC should create when
building a "door" exit. The batch file that invokes RBBS-PC must
check if this file exists whenever RBBS-PC terminates and (if it
exists) execute it (see section 13). This is also the same file name
that is used when the SysOp exits to DOS.
Parameter 104 RBBS.BAT
The path and filename of the .BAT file used to start RBBS-PC. This is
used to re-invoke RBBS-PC after a door (see section 13). This is also
the same file name that is used when the SysOp returns from exiting to
DOS.
Parameter 105 C:\
The DOS subdirectory where RBBS-PC can find the DOS command processor
(COMMAND.COM). This is also the location for the .BAT files which
test and convert compressed uploads.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-13
Parameter 106 YES
The method used to redirect I/O when dropping to DOS as a remote SysOp
(command "7"). Answering YES selects the standard DOS "Change Console
Command" (CTTY), NO selects the DOS redirect function (">" or "<").
This parameter allows you to specify if the redirected output is to be
handled by a SysOp-supplied device driver. If you don't elect to use
a special device driver, RBBS-PC will redirect the output directly to
the communications port by building the command "CTTY COMx" or ">COMx
and <COMx" , where "x" is based on the communications port the node
was configured for. If you specify the name of a device driver,
RBBS-PC will build the command CTTY [driver name].
Parameter 107 <none>
The path and filename of a program (i.e. an .EXE or .COM file) that is
to run when a new users logs on. This feature is intended for those
who feel the need to perform an extensive verification of new users
that is not met by RBBS-PC's built in scripting capability or
automatic subscription functions.
Parameter 108 0
Allows the external program designated via parameter 107 to be invoked
for not only new users, but also for callers who have a security level
equal to or less than the security level specified in parameter 108.
Parameter 109 DOORS.DEF
The path and filename of the "DOORS" control file. See section 14.3
for more information.
10.7 Parameters for RBBS-PC's Security (part 1)
-----------------------------------------------
Parameter 121 SECRET NAME
The first and last name of the SysOp pseudonym. It is this name that
causes RBBS-PC to recognize the remote caller as the SysOp and not
simply a user with a security level equal to that of the SysOp. This
should be a first and last name combination that is not likely to be
selected by other callers. The name supplied in parameters 1 and 2
cannot be used by ANYONE to log on. If the SysOp wants to log on
remotely, the name in parameter 121 must be used.
Parameter 122 NO
If YES, specifies that a LOCAL logon (via the ESC key) should logon as
the SysOp automatically. NO will prompt for a name before allowing
anyone to log on locally.
Parameter 123 0
The minimum security level users need in order to log onto RBBS-PC.
Callers with a security level less than this number will be given an
"ACCESS DENIED" message and immediately disconnected.
Parameter 124 5
The security level assigned to new users. If this security level is
less than the minimum security level to log on, no new users can log
on. This means that no new users are allowed and access is limited
only to pre-registered users.
Parameter 125 10
The minimum security level a user must have in order to be considered
a SysOp. Even if a user has a high enough security level to see the
SysOp menu and execute some or all of the SysOp commands, the user
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-14
will not be treated as a SysOp (i.e. allowed to see the files
upload/download when viewing the CALLERS file) unless the users
security level is equal to or greater than that specified by this
parameter.
Parameter 126 10
The minimum security level required to see the SysOp menu. This does
not give a user SysOp access, it only allows him to see the menu of
SysOp commands.
Parameter 127 10
The minimum security level a user must have to leave an extended (i.e.
multiple line) description of a file that was uploaded. See parameter
40 for the maximum number of lines that an extended description will
be allowed to have.
Parameter 128 5
The maximum number of security violations (i.e. attempts to download
protected files) before the user is logged off and locked out.
Parameter 129 10
The minimum security level to access each SysOp function. These may
all be set to the same level, or each command can have a different
minimum security level.
Parameter 130 <variable>
The minimum security level to access the MAIN commands. These may all
be set to the same level, or each command can have a different minimum
security level.
Parameter 131 <variable>
The minimum security level to access the FILE commands. These may all
be set to the same level, or each command can have a different minimum
security level.
Parameter 132 5
The minimum security level to access the UTILITY commands. These may
all be set to the same level, or each command can have a different
minimum security level.
Parameter 133 <variable>
The minimum security level to access the GLOBAL commands. These may
all be set to the same level, or each command can have a different
minimum security level.
Parameter 134 3
The maximum number of times a user can change their password in a
given session. This prevents a caller from "fishing" for special
passwords.
Parameter 135 5
The minimum security level required in order for users to access
privileged group passwords. If the user's security is less than this
level, ALL password changes that they make will be permanent -- even
if the password they select is in the temporary password file named in
parameter 146.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-15
Parameter 136 10
The minimum security level required to overwrite on uploads. Users
with this security level can REPLACE EXISTING FILES by uploading a
file with the same name.
Parameter 137 10
The minimum security level "exempt" from packing. When the SysOp
packs the user file, callers with this security level or greater will
NOT be removed from the user file, even if they have not called in the
number of months specified in parameter 11.
Parameter 138 5
The default security level of new PRIVATE messages. Only those with
this security level or higher can read new private messages -- even if
they have been addressed to them. This allows the SysOp to "preview"
messages, and then lower the security level of each message so that
the addressee can read it.
Parameter 139 5
The default security level of new PUBLIC messages. Only those with
this security level or higher can read new public messages -- even if
they have been addressed to them. This allows the SysOp to "preview"
messages, and then lower the security level of each message so that
the every user can read it.
Parameter 140 10
The minimum security level required to change the security level of a
message.
10.8 Parameters for RBBS-PC's Security (part 2)
-----------------------------------------------
Parameter 141 is not implemented in RBBS-PC.
Parameter 142 <default dir>
The drive and path where the "personal" files are located. If a file
listed in the directory is not found here, the download drives will
then be searched, so it is not necessary to have a copy of a file here
in order to use personal downloads. However, files in this directory
can be protected so that ONLY personal download will access the files.
Parameter 143 PRIV.DEF
The name of the "personal directory." If no extension is specified,
".DEF" will be used. If not path is specified, the path in parameter
142 will be used.
Parameter 144 <none>
The default protocol to be used when downloading personal files. If
no protocol is specified, the "P" command behaves exactly same as the
D)ownload command. If a protocol is specified, it will be used unless
overridden by the command line (i.e. "P file.ext Z").
Parameter 145 FILESEC
The path and filename of the "file security" list. See section 15.4
for more information.
Parameter 146 PASSWRDS
The path and filename which contains the privileged group passwords
and security-level limits. See section 15.3.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-16
Parameter 147 NO
Specifies that multi-file personal downloads using ASCII should be
done "non-stop." This is useful if the SysOp wants users to download
to a continuous feed printer.
Parameter 148 10
The minimum security a user must have in order to "categorize" uploads
when the SysOp is using the File Management System (FMS). Uploads by
callers with insufficient security to categorize will be placed in the
default "upload" category.
Parameter 149 5
The minimum security to view NEW uploads. RBBS-PC will omit either
ALL files in the "upload" directory, or only those files in the
"upload" category (if the upload directory is the master FMS
directory).
Parameter 150 6
The minimum security to bypass the "epilog" questionnaire, specified
in parameter 85.
Parameter 151 5
The minimum security level required to automatically add a user to a
conference. This parameter is only activate when CONFIG is in
"conference maintenance" mode (see parameter 167). If a caller tries
to join a conference, they will be denied access unless they are
already a member, or their security is at or above this level. Each
conference may have a different setting for this parameter. NOTE:
Sub-boards do NOT use this feature. To restrict access to a
Sub-board, use parameter 123.
Parameter 152 6
The minimum security level for a caller to "turbo logon". This
feature allows a caller to go DIRECTLY to the main menu, bypassing the
welcome, new upload and bulletin displays. To use "Turbo logon", the
user must answer the "What is your FIRST name" prompt with:
firstname lastname password ![conference]
The "!" after the password signals RBBS-PC to use "turbo." If the
conference name is omitted, the caller will be left in the MAIN
conference. If the caller substitutes a "$" for the "!", Only the
WELCOME will be bypassed. This is helpful for systems with extensive
ANSI welcome screens that can be tedious for old callers.
Parameter 153 10
The minimum security required by a caller to add a description for an
existing file. Typically this is restricted to the SysOp only. It
can be used by the SysOp to create FMS directories. After placing the
files in the upload subdirectory (or anywhere in the download path)
the SysOp can use RBBS-PC to add descriptions for the files. RBBS-PC
will first ask if you wish to OVERWRITE the file. If you answer NO,
RBBS-PC will then ask if you wish to add a description. In this way,
RBBS-PC will properly build the directory entry.
Parameter 154 SECVIO.HLP
The name of the help file that is shown to a caller whenever the
caller incurs a security violation. RBBS-PC will add the HELP
directory and EXTENSION (from parameters 64 and 66).
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-17
Parameter 155 <none>
Denies callers access to one or both of RBBS-PC's "premium features --
DOORS and file downloading, for a specific period of time. This can
be used to direct the callers' attentions to other features of RBBS-PC
(such as message bases). The PASSWRDS file (see section 15.3)
specifies how many SECONDS the caller must be online before the
premium features are available. If a caller tries to use a locked
feature before the time has elapsed, the caller will be given a
message and denied access. This is *NOT* recorded as a security
violation.
The file TIMELOCK.HLP should be placed with the other RBBS-PC HELP files.
This file (if found) will be shown to a user who is locked out of a
command. If the TIMELOCK.HLP file is not available, the caller will be
given a "canned" message: "Sorry, (name), try that function later."
Parameter 156 10
The minimum security to be exempt from automatic security updates. If
the caller's MAIN security level is changed, their security level in
conferences will also be changed if their security in the conference
is less than this setting. This allows the SysOp to adjust their
security in the MAIN conference, and RBBS-PC will make the adjustments
in each conference and sub-board. If the SysOp increases a caller's
security in a conference (to make them a "SIGOp"), The caller will
maintain this increased security only if it is above this setting.
Parameter 157 10
The minimum security a caller must have to be able to read and kill
all messages (in the message base for which this is a .DEF file).
This allows the SysOp to create an "assistant MESSAGE SysOp" who can
police message traffic, without granting that user full SysOp
privileges.
Parameter 158 SEEN-BY:
Specifies a text string that, if found at the start of a message line,
will NOT be shown to the caller. This can be used to hide the
sometimes enormous network routing data found in network mail.
10.9 Parameters for Multiple RBBS-PC's/Conferences
--------------------------------------------------
Parameter 161 1
The maximum number of RBBS-PC nodes. Up to 36 RBBS-PC's can share the
same files. Different environments have different maximum number of
nodes that they can effectively support. Setting this parameter
configures the MESSAGE files so they contain the appropriate number of
"node" records.
Parameter 162 DOS
The environment that multiple copies of RBBS-PC will be sharing files
in. This is necessary so that RBBS-PC can use the mechanism that is
appropriate to the specific environment when sharing files. RBBS-PC
currently can handle the following environments for multiple
RBBS-PC's:
0) Single node under DOS
1) MultiLink (The Software Link, Inc.)
2) OmniNet (Corvus)
3) PC-Net (Orchid)
4) DESQview (Quarterdeck Office Systems)
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-18
5) 10 Net (Fox Research)
6) IBM's NETBIOS
NOTE: Many manufacturers utilize Orchid's network conventions. As an
example, AST and Alloy are both vendor's whose "network" is .EXE file-
compatible with Orchid's. If you have a network of PC's, check with
the vendor to see how compatible their network is with those supported
by RBBS-PC.
Parameter 163 INTERNAL
Specifies the method RBBS-PC uses to recycle after a call. INTERNAL
recycling is done within the RBBS-PC.EXE file. SYSTEM recycling exits
RBBS-PC, and expects the invoking .BAT file to recycle. Internal is
faster, but System allows an external event to be processed after each
caller.
Parameter 164 8
The number of records in the USERS file. This number must be an even
power of 2 (256, 512, 1024, 2048, etc.). When the USER file is almost
full, the SysOp will either have to "rebuild" the user file (see
parameter 182) or increase this file size. The SysOp can check on the
freespace in this file with the RBBS-PC "statistics" command (UTIL
section). Parameter 291 lets new users on even if the users file is
full.
Parameter 165 27
Specifies the default number of records in the MESSAGES file. Each
file is 128 bytes. The number of messages that can be stored is a
function of the number of lines allowed per message. The minimum size
of the MESSAGES file is equal to 1 (The "checkpoint" record) plus the
maximum number of concurrent RBBS-PC's ("node" records) plus the
maximum number of messages allowed multiplied by 5 (each messages is
assumed to average five 128-byte records)
Parameter 166 5
The maximum number of messages allowed in the message file at any one
time. The absolute upper limit on the number of messages is 999.
If you specify 250 messages, you can expect that the MESSAGES file
will be formatted to more than 160K in size. If you allow the message
file to grow (parameter 170), only parameter 166 will limit the growth
of the file. If your message file does not grow, both the number of
messages, and the number of records will limit how many messages can
be left.
Parameter 167
Enters "conference maintenance" This allows you to set features or do
maintenance on CONFERENCES (not Sub-boards!). You will be asked for
the conference name, which can be up to 7 characters (CONFIG will add
an "M" to the conference MESSAGE filename, and a "U" to the USER file
name). While in conference maintenance mode, you can create
conference message and user files, perform maintenance on them, or set
conference variables (see parameter 151. To perform maintenance on a
Sub-board, you should start config with the sub-board .DEF file (i.e.
CONFIG MYSUBC.DEF). If you change the size of a conference MESSAGE or
USER file, the change will take place when press the END key while in
conference maintenance mode.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-19
Parameter 168 ZIP
The default file extension for uploads and downloads. If a file is
UPLOADED, and the user does not specify an extension, this default
will be used. If a file DOWNLOAD request does not specify an
extension, the default will be used. In order to upload files with NO
extension, a "." must follow the name (i.e. U MYFILE. Z).
Parameter 169 <none>
Additional file extensions in addition to the default, to search when
looking for an uploaded file, to decide if it is already present. A
file will be considered already in the catalog if the prefix matches.
Warning: this search can be time consuming unless you have installed
the Fast File Search. Every extension listed should begin with a
period. E.g. ".ARC.PAK" would count an upload of XYZ.ZIP as a
duplicate if the file XYZ.PAK or XYZ.ARC exists.
Parameter 170 NO
Allows the MESSAGE files to "grow." If the limit on active messages
(parameter 166) has not been exceeded, and the number of records has
been exhausted, RBBS-PC will increase the size of the message file to
accommodate more messages. NOTE: The Corvus Network software does not
allow a message file to grow.
10.10 RBBS-PC SysOp Utilities
-----------------------------
Parameter 181
Packs the message base. When a message is "killed," the space used
by that message is not freed (this allows a message to be
"resurrected). Parameter 181 makes a backup of the message file, then
reclaims the space used by killed messages.
Parameter 182
Removes deleted users and users who have not been on the system within
the number of months specified in parameter 16. You should have
enough free disk space for a second copy of the users file (with a
qualifier of ".BAK") or the rebuilding will terminate abnormally (the
users file will be restored). NOTE: Locked-out users (security less
than 0) will not be removed from the file.
Parameter 183
Displays the message headers of all messages, active and killed, that
are present in the message file. This is left over from one of the
many "debugging" stages of RBBS-PC prior to CPC09. Following the
policy of making all changes "additive", this function has been
retained. It may help some SysOps recover from disk hardware
failures.
Parameter 184
Renumbers messages. An RBBS-PC message number cannot be higher than
9999. This function will renumber the active messages, utilizing
numbers once used by deleted messages. Also, each caller's high-
message pointer will be updated to reflect the renumbered message.
Parameter 185
Scans the message file and reconstructs the chains that link the
messages together. Message files that have "blank" messages or
abbreviated messages (i.e. some lines of text are missing) can be
repaired with this facility.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-20
Parameter 186
Sets a flag in all USER records that will require the user to answer
the required questionnaire (see parameter 82).
Parameter 187
Scans the FMS directory to be sure each record conforms to the exact
format required by the FMS (in case the text editor used by the SysOp
to edit the file inserted tabs or shorten lines that had trailing
blanks at the end of them).
Parameter 188
Scans the PERSONAL download directory to be sure the format is proper
for a PRIV.DEF file.
Parameter 189
This parameter will guide the SysOp, sequentially, through only those
parameters that would normally have to be changed when setting up a
new RBBS-PC.
Parameter 190
This parameter will guide the SysOp, sequentially, through the
parameters that are new and/or changed for the current release of
RBBS- PC.
Parameter 191
Will turn the "printer enabled" flag off in all the node records.
This is useful if somehow the printer is accidentally enabled, but no
printer exists (a condition which will halt RBBS-PC).
Parameter 192
Scans the USER file and turns the "highlight" feature off for any user
who did not select COLOR. This will rescue confused callers from the
problem of receiving ANSI sequences when their terminal does not
support ANSI.
10.11 RBBS-PC's File Management System Parameters
-------------------------------------------------
Parameter 201 C:
The drive letter where uploads should be placed. Enter only the DRIVE
letter here. The exact subdirectory can be entered in parameter 208.
Parameter 202 99
The name of the directory file where RBBS-PC should place upload
descriptions. This upload directory can be the master FMS directory,
or a separate upload directory.
Parameter 203 C:
The drive/path were the upload directory is to be found.
Parameter 204 C
The letters of the drives from which files can be downloaded. The
order in which they are specified is the order in which the drives
will be searched. If the order is BAC, then drive B will be searched
first for the file, then drive A, and finally drive C. While there
can be duplicate files on each of the drives, the first file found
will be the one downloaded to the user.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-21
Parameter 205 NO
Specifies that DOS subdirectories are used. This is a reflection of
RBBS-PC's early history (before DOS supported subdirectories) and
should always be set to YES.
Parameter 206 NO
Specifies that uploads are to be sent to DOS subdirectories. This is
a reflection of RBBS-PC's early history (before DOS supported
subdirectories) and should always be set to YES.
Parameter 207 NO
Specifies that downloads are separated into DOS subdirectories. This
is a reflection of RBBS-PC's early history (before DOS supported
subdirectories) and should always be set to YES.
Parameter 208
Specifies the DOS subdirectory where UPLOADS are placed, and a list of
subdirectories where DOWNLOADS are searched. This is only functional
if you have responded "Yes" to either parameter 206 or parameter 207.
The FAST FILE SEARCH can be used in conjunction with this directory
list to find downloads (see section 12.9).
Parameter 209 DIR
The file extension for RBBS-PC directory files.
Parameter 210 <none>
An alternative extension to be used for "directory" files. The main
use for an "alternate" extension is to allow "sub-boards" to share
directories using the main extension (parameter 209), but also have
some directories unique to the "sub-board" that are not shared with
others.
Parameter 211 DIR
The name (prefix only) of the directory of directories. This file
lists either the names of other .DIR files, or FMS category codes (see
section 12).
Parameter 212 NO
Allows the SysOp to exclude the directory of directories from the
search done by the New command. If your directory of directories
does not contain FILE descriptions, but only directory descriptions,
you will probably not want it searched by the "new" command.
Parameter 213 NO
Specifies an additional file to place upload descriptions. This could
be used to maintain a downloadable list of ALL files, or a bulletin of
NEW uploads.
Parameter 214 <none>
The name (without path or extension) of the master FMS directory. See
section 12.3 for a full description of the advantages of using FMS
Parameter 215 NO
Limits the search for directories to the master FMS directory. If you
have multiple .DIR files, set this parameter to NO. If you only use
FMS, set this parameter to YES to increase the speed of directory
searches.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-22
Parameter 216 UNC
The default category code for uploads. This parameter is how uploads
get classified in the FMS directory if the uploader does not have
sufficient security to categorize an upload. If this category is
"***," only the SysOp will see the new upload.
Parameter 217 DIR.CAT
The name of the file which tells RBBS-PC what categories are included
in the FMS directory. The format of the file is described in section
12.5.
Parameter 218 NO
Specifies what directories will be listed in a request for "all"
directories. This parameter is REQUIRED in order for "all" to be
defined as an option. Begin with "@" if you want to specify a list of
directories. For example, "@C:\RBBS\ALLDIR.LST" means that the text
file "ALLDIR.LST" on drive C in subdirectory ALLDIR contains a list of
directories to search when "all" is specified. The directories in
ALLDIR.LST should use the same names as the caller would type in, one
to a line. E.g. if "all" is the search directories 1,3, and 4,
ALLDIR.LST should contain
1
3
4
You can also specify a specific directory to confine all to by including an
entry not beginning with "@", e.g. "FMS" would list directory FMS.DIR,
located in the drive/path specified where directory files go. If you want
to disable the search for "all", just press Enter in response to this
parameter.
Parameter 219 40
The maximum length of the description that can be given to an uploaded
file. RBBS-PC can be configured so that those who upload files can
provide a description of the file they upload. This description
informs others what the file does and helps them decide whether they
want to download the files. The maximum length of the description can
be set to any value between 40 and 46. WARNING: If you change this
option, you must manually change all existing directories.
Parameter 220 C:
The drive and directory where all directory files must be put, except
possibly for the upload directory. Only in this DOS directory does
RBBS-PC look for RBBS-PC directory files, with the sole exception of
the upload directory when the caller's security level permits the
upload directory to be viewed (see parameter 149).
10.12 Communications Parameters (part 1)
----------------------------------------
Parameter 221 COM1
The communication port that RBBS-PC will use. If you specify COM0,
RBBS-PC will run in "local" mode, allowing you to run RBBS-PC without
a modem. RBBS-PC can support COM1 and COM2 directly, or it can
support a FOSSIL driver, and thereby support any communications port
supported by the FOSSIL.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-23
Parameter 222 3
The number of seconds that RBBS-PC should wait after initializing the
modem with a "reset" command. Many modems require only 1 second to
reset, however some may require much (MUCH) longer.
Parameter 223 1
The number of seconds to wait prior to issuing a modem command. This
is most useful when you have configured RBBS-PC to only issue commands
between rings and want the modem to "settle down" after a ring has
ended. If you find that 2400 baud calls are improperly connected at
1200 baud, increase the wait. Some modems take longer to connect at
2400 than at lower speeds.
Parameter 224 1
The number of rings to wait before answering the phone. Specifying
zero rings means that the modem (not RBBS-PC!) will answer the phone
as soon as it rings. NOTE: RBBS-PC's control of answer mode is an
important part of its security. Setting parameter 224 to ZERO
bypasses this security! If you specify one or more rings, the modem
must be able to tell RBBS-PC when the phone is ringing (via RS-232 pin
22 or the "RING" response string). The modem must also be able to
count rings in its S-registers. You can also specify "Ring-Back."
This instructs RBBS-PC to IGNORE a ringing phone, but if the phone
stops ringing (for more than 10 but less than 45 seconds) and then
starts ringing again, RBBS-PC will answer. This is useful for non-
dedicated phone lines, or hearing-impaired SysOps who want to use both
TDD (telecommunications device for the deaf) and RBBS-PC. A caller
who wants the SysOp to use TDD will let the phone ring until the TDD
connects, but will call, let the phone ring once then hang up, and
then call BACK to get RBBS-PC to answer the phone.
Parameter 225
Sets the commands RBBS-PC uses to communicate with the modem. A list
of SysOp-supplied settings for various modems is also available (See
section 11).
Parameter 226
Activates software-based MNP support. This option is no longer
available, unless Microcom can supply a library that is compatible
with current Microsoft BASIC compilers. RBBS-PC does support MNP
protocol that is hardware-based (i.e. built into the calling and
answering modems).
Parameter 227 NO
Restricts RBBS-PC so it will only issue modem commands BETWEEN rings.
Some modems cannot handle the telephone ringing and accept modem
commands simultaneously. Most modems do NOT require this restriction.
Parameter 228 300
The speed RBBS-PC should initialize the modem to. Most modems will
only REDUCE speed when automatically detecting baud rate, so this
value should be set to the maximum speed supported by your modem.
Parameter 229 180 seconds
The number of seconds RBBS-PC will wait before disconnecting an "idle"
caller. If a caller walks away from an RBBS-PC session, RBBS-PC will
first warn the caller, then disconnect the call after the specified
number of seconds.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-24
Parameter 230 NO
Specifies a "dumb" modem is being used. Selecting this means that no
modem commands are sent from RBBS-PC to the modem. This can be used
to connect RBBS-PC to a communications network (i.e. TymNet) or local
area network that supplied a simple RS-232 interface. Selecting this
option causes RBBS-PC to
- Issue no Hayes commands,
- Depend on no Hayes-like responses,
- Control the interface with the Data Terminal Ready (DTR),
- Assume somebody has called whenever Carrier Detect (CD) is
detected, and
- Assume that whomever calls is at the baud rate selected in CONFIG
parameter 228.
Parameter 231
Initializes the modem's firmware for use by RBBS-PC. The commands
used to perform firmware initialization can be modified with parameter
225.
Parameter 232 3
The number of seconds to wait after dropping DTR (Data Terminal
Ready). RBBS-PC drops DTR in order to disconnect a caller. Too short
a delay will cause the modem not to re-initialize properly.
Parameter 233 PROTO.DEF
The path and filename of the external protocol driver file (see
section 20).
Parameter 234 NO
Activates RBBS-PC's check for AutoDownload support (supported by the
PC-TALK terminal emulator) at the start of each call. This check is
incompatible with some terminals and communications packages, causing
them to stop displaying on the local screen. The caller can control
whether autodownload is used with the T)oggle command in utilities.
It is recommended that this option NOT be enabled.
Parameter 235 YES
Instructs RBBS-PC to force downloads with "binary" file extensions
(i.e. .ARC, .ZIP, .EXE, .COM, .OBJ, .WKS, .BAS, or whose second letter
of the extension is Q) to non-ASCII protocols.
Parameter 236 <don't recycle>
Instructs RBBS-PC to "recycle" after a number of minutes passes
without receiving a call. This may help recover from a modem
malfunction. Set this value to the number of minutes an "idle"
RBBS-PC could mean a modem problem. Specifying 0 means that RBBS-PC
will not re-cycle, no matter how many minutes elapse between calls.
Parameter 237 NO
Forces RBBS-PC to leave the modem at the baud rate it was initially
opened at rather than automatically matching the baud rate of the
caller. RBBS-PC normally changes the baud rate in the RS-232
interface to match that of the callers. Some modems allow RBBS-PC to
transfer at maximum speed on all calls, while the modem handles the
speed conversion. In this case you would set parameter 237 to YES.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-25
10.13 Communications Parameters (part 2)
----------------------------------------
Parameter 241 NO
Instructs RBBS-PC to switch back to the original parity/word length
setting after a binary transfer. If a caller using 7bit, even parity
requests a binary transfer, RBBS-PC will switch to 8bit, no parity.
Parameter 241 controls whether RBBS-PC stays at 8bit or reverts to
7bit after the transfer. Most environments can remain at 8bit after a
transfer.
Parameter 242 0
Specifies the minimum modem speed that new callers can have. If a new
caller connects at a speed less than that specified, RBBS-PC will deny
access to that caller.
Parameter 243 0
Specifies the minimum modem speed for OLD callers. With this
parameter, you can block any NEW callers at 300bps, but allow a pre-
registered caller access at that speed.
Parameter 244 NO
Activates CTS (clear to send) and RTS (request to send) flow control.
This hardware flow control uses RS-232 pins 4 and 5 to control the
flow of data between RBBS-PC and the modem.
Parameter 245 NO
Activates XON/XOFF flow control. This software flow control uses
ASCII codes to control the flow of data between RBBS-PC and the modem.
NOTE: RBBS-PC only supports XON/XOFF at the end of each buffer. If
RBBS-PC is to quickly respond to XON/XOFF, set parameter 54 to a small
number.
Parameter 246 30
The maximum time to RBBS-PC should wait for carrier after answering
the phone.
10.14 Parameters for RBBS-PC NET-MAIL
-------------------------------------
Parameter 261 <none>
Specifies the time of day in HHMM format at which RBBS-PC is to
perform a "daily event." At this time, RBBS-PC will create a "daily
event" signal file, and exit to DOS. The signal file is in the form
"RBBS?TM.DEF", where ? is the node number. See section 13 for a
complete description of the requirements for .BAT files when doing
daily events.
Parameter 262 <none>
Selects a network "front end" for use with RBBS-PC. Currently,
RBBS-PC supports the following front-ends: SeaDog and BinkleyTerm (see
Appendix S). By enabling this option, the SysOp assumes the
responsibility of configuring the "net mail" application to:
1. answer the phone and determine if the caller is sending "net
mail".
2. if the caller is not sending "net mail", the net mail application
must invoke RBBS-PC with the following command line:
RBBS-PC.EXE nodeid filename /time /baud /RELIABLE
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-26
where:
- "nodeid" is the node ID in the range 1-9, 0, or A-Z.
- "filename" is the fully qualified file name to use as the
RBBS-PC ".DEF" file.
- "/time" is the time of day for RBBS-PC to return to the "net
mail" application that called RBBS-PC.
- "/baud" if the baud rate that the caller dialed in at.
- "/RELIABLE" tells RBBS-PC whether the connection has error
correction built into the connected modems
Parameter 263 <none>
The command to turn on intermediate host echo. This is intended to be
used when RBBS-PC is connected to a public data network (PDN) as a
"node" -- not all systems that people log into on a PDN need be "main
frame" computers! When RBBS-PC is a node on a public data network,
typically the network will do the echoing -- between the caller and
the port they access on the PDN and between RBBS-PC and the port
RBBS-PC accesses on the PDN. This causes file transfers to be a
problem because the PDN will continue to echo. Therefore it is
necessary to be able to go into an "image" mode where data is passed
through the PDN intact with no echoing. The contents of this string
will be sent AFTER a file transfer so the network will resume echo.
Any character can be included in the string using it's decimal ASCII
equivalent simply by putting a number inside square brackets.
Characters not in square brackets will be transmitted as they were
entered. The string "a[32]" will be interpreted as a lower case
letter "a" followed by a blank.
Parameter 264 <none>
The string that sent BEFORE a file exchange that causes the PDN to
STOP echoing. As with parameter 263, the contents of this string is
entirely dependent on the predilections of the PDN that RBBS-PC is
attached to.
Parameter 265 RBBS-PC
Specifies who should echo characters sent to RBBS-PC. Normally,
RBBS-PC echoes back to the caller, but un a PDN, or callers who use
TDDs may want to change this value to either an intermediate host, or
to the caller's system.
Parameter 266 <none>
The string RBBS-PC will use to acknowledge each line in an ASCII
protocol upload. Typically, an ASCII upload is characterized by two
fundamental features -- it contains no unprintable characters and it
does not require any "error checking". Under some circumstances a
callers communications protocol may require a response from RBBS-PC
(i.e. a line feed) before the next line will be transmitted.
Parameters 267 FIDX.DEF
The path and filename of the FFS (Fast File Search) sorted names file
(see section 12.9).
Parameter 268 LIDX.DEF
The path and filename of the FFS (Fast File Search) "tabs" file (see
section 12.9).
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-27
10.15 New Users Parameters
--------------------------
Parameter 281 YES
Instructs RBBS-PC to allow new callers to set their default system
values. RBBS-PC typically asks new users their choice of line feeds,
graphics, transfer protocol, and "turbo-key". Sometimes these
questions confuse new users, who lack the knowledge to answer them.
Parameter 281
Not implemented in this release of RBBS-PC.
Parameter 282
Not implemented in this release of RBBS-PC.
Parameter 283
Not implemented in this release of RBBS-PC.
Parameter 284
Not implemented in this release of RBBS-PC.
Parameter 285
Not implemented in this release of RBBS-PC.
Parameter 286
Not implemented in this release of RBBS-PC.
Parameter 287
Not implemented in this release of RBBS-PC.
Parameter 288
Not implemented in this release of RBBS-PC.
Parameter 289
Not implemented in this release of RBBS-PC.
Parameter 290 YES
Specifies new users should be saved in the USER file. If set to NO,
new users may log in, but RBBS-PC will not "remember" them on
subsequent calls.
Parameter 291
Instructs RBBS-PC to allow new users when the USER file is full. In
this case, RBBS-PC will not "remember" new callers on subsequent
calls, until the USER file is expanded to accommodate more records.
10.16 Use of the Library Sub-System
-----------------------------------
Parameter 301 <none>
Activates the Library Sub-System (see section 12.6). Specify a drive,
which must NOT be a drive used by any other RBBS-PC function.
Parameter 302 <default dir>
The drive/path where RBBS-PC will find the upper directory (CDR.CDR is
the default name).
Parameter 303 CDR
The file extension that identifies library directory files.
RBBS-PC 17.3A TECHNICAL REFERENCE MANUAL 10-28
Parameter 304 <default dir>
The drive/path of the Library "work disk." This is where the Library
sub-system creates archive files for transmission. Normally, 360K of
free space is required, so a RAM disk is suitable.
Parameter 305 705
The number of disks available in the library.
Parameter 306 7
The maximum number of upper level directories that will be found on
the Library disk. The PC-SIG CD-ROM is organized with 10 upper level
directories, 1-100, 101-200, 201-300 etc. and each of these contain
100 directories, DISK001, DISK002 etc.
Parameter 307 100
The maximum number of subdirectories that each upper level directory
can contain.
Parameter 308 DISK
The prefix of the lower level directories. Since the user enters only
the disk number that is desired, RBBS-PC creates the subdirectory name
based on this parameter and the number entered.
Parameter 309 MENU6
The drive\path\name of the Library Sub-system menu.
Parameter 310
The list of command symbols that are available from the Library
Sub-System menu.
Parameter 311 <variable>
The security values related to the symbols listed in parameter 310.
Parameter 312 <default dir>
The drive\path where the archive utility program can be found.
Parameter 313 ARCA
The archive utility that will do the archiving on Library disks. When
answering the questions to this parameter you will also be asked what
the CREATE parameter is. For PKARC and ARC the correct response is
"A". If using ARCA there is no CREATE parameter since CREATE is the
only function that it can do.
10.17 RBBS-PC's Parameters for Color
------------------------------------
Parameter 321 [27][1;41;37m
The string that turns ON highlighting or emphasizing of characters in
text strings displayed to the caller (see section 7.10).
Parameter 322 [27][0;40;33m
The string that turns OFF highlighting or emphasizing of characters in
text strings displayed to the caller.
Parameter 323 Bright Green
Foreground color 1. The SysOp can select this color in menus and text
by using the SmartText command C1.
USING THE "CONFIG" UTILITY TO CONFIGURE RBBS-PC 10-29
Parameter 324 Bright Yellow
Foreground color 2. The SysOp can select this color in menus and text
by using the SmartText command C2.
Parameter 325 Bright Purple
Foreground color 3. The SysOp can select this color in menus and text
by using the SmartText command C3.
Parameter 326 Bright Cyan
Foreground color 4. The SysOp can select this color in menus and text
by using the SmartText command C4.
Parameter 327 <none>
The background color used against the preceding four foreground
colors.